home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1999 March / EnigmA AMIGA RUN 35 (1999)(G.R. Edizioni)(IT)[!][issue 1999-03].iso / earcd / misc / pdflib / readme < prev    next >
Text File  |  1999-01-01  |  6KB  |  187 lines
  1. PDFlib V0.6
  2. ===========
  3. Portable C library for dynamically generating PDF ("Adobe Acrobat") files.
  4. Thomas Merz (tm@muc.de)
  5.  
  6. The PDFlib distribution is available from the following URL:
  7. http://www.ifconnection.de/~tm
  8.  
  9.  
  10. Overview
  11. ========
  12. PDFlib is a C library for generating PDF files. It offers a graphics
  13. API with support for drawing, text, font and images. Call PDFlib
  14. routines from within your client program and voila: dynamic PDF files!
  15. For detailed instructions on PDFlib programming and the associated API,
  16. see the PDFlib Programming Manual, included in PDF format in the
  17. PDFlib distribution.
  18.  
  19. Using a cute facility called SWIG, PDFlib can also be used from
  20. within the Perl, Tcl, and Python scripting languages. As of version
  21. 0.6, scripting support is only available for Unix systems.
  22.  
  23. Features
  24. ========
  25. - basic drawing
  26.   lines, rectangles, arcs, Bezier curves, ...
  27.   gray scale or RGB color
  28. - text
  29.   text in different fonts and sizes, formatting
  30.   type 1 font embedding, AFM support
  31. - output formats
  32.   ASCII85, ASCIIHex, or binary
  33. - graphics file formats
  34.   support for TIFF, GIF, and JPEG files
  35. - hypertext features
  36.   bookmarks (outline entries)
  37.   page transitions
  38.  
  39.  
  40. PDFlib application ideas
  41. ========================
  42. - Dynamic PDF generation via CGI from a Web server
  43. - Directly convert text or graphics files to PDF
  44. - Report generator for applications such as databases
  45. - Substitute for Adobe's PDFwriter
  46. - ... you name it!
  47.  
  48.  
  49. Supplied Library Clients
  50. ========================
  51. PDFlib includes some demo, test, and "real" client programs:
  52.  
  53. - hello:    simple "hello, world!" program
  54. - pdfdemo:    illustrates many PDF features
  55. - imagepdf:    convert GIF/TIFF/JPEG images to PDF
  56. - text2pdf:    convert text files to PDF
  57. - pdfclock:    generate a PDF file with one or more analog clock images
  58. - pdfgraph:    draw a graph according to data read from a text file
  59.  
  60. - the hello and pdfclock samples are also available in Perl, Tcl,
  61.   and Python implementations
  62.  
  63.  
  64. Platform support
  65. ================
  66. PDFlib is primarily targeted at Unix systems, although the code
  67. compiles under other systems, too.
  68.  
  69. As far as the C source code is concerned, porting to other platforms
  70. should be straightforward. You will however have to fiddle with
  71. the build process.
  72.  
  73.  
  74. Building the library on Unix systems
  75. ====================================
  76. The library is being developed with GNU C on Linux. If you have a
  77. similar setup, simply copy or link makefile.gcc and call make:
  78.  
  79. ln -s makefile.gcc makefile
  80. make test
  81.  
  82. This builds the library, the supplied library clients, and runs some tests.
  83. If you don't have or don't want tifflib, read the comments at the 
  84. beginning of the makefile and remove the TIFF options.
  85. For other systems you may have to change compiler and path settings.
  86.  
  87. To check for correct program generation, you can do a "make test" 
  88. and open the PDF files in the test subdirectory with Acrobat Reader 
  89. or xpdf. Note that the test run produces several warning messages 
  90. -- this is OK.
  91.  
  92. If your system doesn't offer getopt, you can use the supplied
  93. public domain getopt module instead. By default, this module
  94. is not used, so you have to add it manually in the makefile.
  95.  
  96.  
  97. Building the library on Windows NT
  98. ===================================
  99. I also test-compiled the library with Watcom C/C++ 10.6. Use the
  100. supplied makefile.wat for this platform. Since the makefile uses
  101. backslashes for line continuation, you have to supply the unix 
  102. compatibility option to Watcom make:
  103.  
  104. copy makefile.wat makefile
  105. wmake /u test
  106.  
  107.  
  108. External code/libs used in PDFlib (why re-invent the wheel?)
  109. =================================
  110. PDFlib heavily relies on other people's code, although some of it is
  111. not currently in use:
  112.  
  113. - Sam Leffler's TIFFlib (only if you want to read TIFFs with PDFlib)
  114.   available from ftp://ftp.sgi.com/graphics/tiff/doc
  115. - Adobe's AFM parser
  116.   (supplied with PDFlib)
  117. - ZLIB compression library (soon to be used for PDF 1.2 compatible compression)
  118.   available from http://www.cdrom.com/pub/infozip/zlib
  119. - PD getopt module
  120.   (supplied with PDFlib, rarely needed on Unix systems)
  121. - IJG's JPEG library for certain non-PDF-compatible JPEGs
  122.   (not yet used)
  123. - A rewrite of David Koblas' giftoppm.c
  124.   (supplied with PDFlib)
  125.  
  126.  
  127. A Shameless Plug
  128. ================
  129.  
  130. My latest book has more information on PDFlib and PDF/Web integration.
  131. The book is currently available in German and English:
  132.  
  133. Mit Acrobat ins World Wide Web
  134. Effiziente Erstellung von PDF-Dateien und ihre Einbindung ins Web.
  135. Thomas Merz Verlag Muenchen 1997, ISBN 3-9804943-1-4.
  136.  
  137. Web Publishing with Acrobat/PDF
  138. Springer-Verlag Heidelberg Berlin New York 1998, ISBN 3-540-63762-1
  139.  
  140. To find out more about PDF, Acrobat, and PostScript in general,
  141. read my book:
  142.  
  143. PostScript & Acrobat/PDF
  144. Applications, Troubleshooting, and Cross-Platform Publishing
  145. Including CD-ROM for MS-DOS/Windows/Macintosh/Unix ISBN 3-540-60854-0,
  146. Springer Verlag, Heidelberg, Berlin, New York 1996
  147. orders@springer.de
  148.  
  149. The book is also available in German:
  150.  
  151. Die PostScript- und Acrobat-Bibel
  152. Was Sie schon immer ueber PostScript und Acrobat/PDF wissen wollten.
  153. CD-ROM fuer MS-DOS/Windows/Macintosh/Unix. ISBN 3-9804943-0-6
  154. Thomas Merz Verlag, Muenchen, Fax +49/89/29 16 46 86
  155.  
  156.  
  157. Use and Copyright
  158. =================
  159. This software is subject to the "ALADDIN FREE PUBLIC LICENSE". The
  160. complete text of the license agreement can be found in the file
  161. LICENSE. In short and non-legal terms:
  162.  
  163. - You may use and distribute PDFlib non-commercially
  164. - You may develop free software with PDFlib
  165. - You may NOT sell any software based on PDFlib without
  166.   prior written permission from the author.
  167. - If you write PDFlib programs and sell them, you need a commercial license
  168.  
  169. Note that this is only a 10-second-description which is not legally
  170. binding. Only the text in the LICENSE file is considered to completely
  171. describe the licensing conditions.
  172.  
  173. If you use this software you need to honor the copyright notices. I would
  174. also be interested in knowing about it and, hopefully, be acknowledged.
  175.  
  176. Copyright (c) 1997-98 Thomas Merz. All rights reserved.
  177.  
  178.  
  179. Thomas Merz
  180. Consulting & Publishing
  181. Tal 40
  182. 80331 Muenchen, Germany
  183.  
  184. tm@muc.de
  185. http://www.ifconnection.de/~tm
  186. fax +49/89/29 16 46 86
  187.